home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / pcblist2.zip / PCBLIST2.DOC < prev    next >
Text File  |  1993-06-12  |  9KB  |  202 lines
  1.  
  2. Page 1     PCBLIST2.DOC
  3.  
  4.  
  5.                                    PCBList2
  6.                       PCBoard Directory Compilation Program
  7.                                 by MidWest BBS
  8.  
  9.  
  10.  
  11.                                     PROLOGUE
  12.  
  13. A couple of years ago I wrote a very popular program which gathered
  14. specified PCBoard DIR files and created two lists, one sorted by date
  15. and one alphabetical, of all the files.  Many Sysops around the country
  16. use it in their event every day to create the lists for downloading.
  17. Frankly, if you don't need the multi-line features of the new program
  18. there is little reason to change.
  19.  
  20. This new revision is the direct result of the implementation of multi-line
  21. file descriptions implemented in PCBoard 14.0.  Originally,  I personally
  22. didn't care for them, but as time has passed I have begun to appreciate
  23. the utility they bring (if not overdone!).  As I recoded the program, I
  24. tweaked it here and there and made it smarter in locating files etc.
  25. Also, it's a lot prettier (WHO CARES!).  Frankly, the logic to recognize
  26. and anticipate the variations for multiple line descriptions was a bigger
  27. job than I expected.  Hopefully, most variations will be accomodated -
  28. only time will tell.
  29.  
  30.  
  31.                                    LICENSE
  32.  
  33. You are free to do anything you please with this program - use it, sell it
  34. (good luck), ignore it or line the bird cage.  Just remember, I'm no
  35. programmer, Samuel Smith is a programmer.  So, use it at your own risk.
  36. I've tried to make the screens as informative as possible as to what is
  37. going on and will further explain it in the documentation.  If you can use
  38. it, feel free to do so.
  39.  
  40.  
  41.                                    SET UP
  42.  
  43. I hate configuration files!  My disk is littered with cfg, cnf, dat etc.
  44. Well, here's one more.  There was no way that I could maintain the
  45. flexibility that I felt was necessary and avoid it.  Possibly the answer
  46. lies in a self-modifying program like QEDit, but even that approach has
  47. its drawbacks.  Directly reading the PCBoard.Dat and CNames files totally
  48. destroys the flexibility I wanted.  Enough explanation.
  49.  
  50. Incidentally, for those running the original PCBList, there is no change
  51. in the format and structure of the configuration file.  Just use it the
  52. way it is (You're welcome).
  53.  
  54. When PCBList2 starts, it looks for the configuration file used on the
  55. command line.  If there is none, it will search for a file named
  56. PCBList.Ctl.  The command line option is really there to allow multiple
  57. configurations for specialized lists (by conference, topic etc).  The
  58. configuration file looks like this:
  59.  
  60.  
  61. Page 2     PCBLIST2.DOC
  62.  
  63.  
  64. MidWest BBS - Illinois' Professional Bulletin Board
  65. 24 Hours per Day    300/1200/2400/9600(HST) Baud
  66. (312) 513-1034
  67. E:midwest.lst
  68. E:midsort.lst
  69. 10
  70. c:\pcb\gen\dir1
  71. c:\pcb\gen\dir2
  72. c:\pcb\gen\dir3
  73. c:\pcb\gen\dir4
  74. c:\pcb\gen\dir5
  75. c:\pcb\gen\dir6
  76. c:\pcb\gen\dir7
  77. c:\pcb\gen\dir8
  78. c:\pcb\gen\dir9
  79. c:\pcb\gen\dir10
  80.  
  81. The first three lines are any B.S. you want to put at the top of the
  82. listing.  Each line is limited to 78 characters and will be centered when
  83. the program is run.
  84.  
  85. Line 4 is the name (including path if you wish) of the list which will be
  86. sorted alphabetically.
  87.  
  88. Line 5 is the name of the list sorted by date.
  89.  
  90. Line 6 is the total number of directories to be scanned.  This is limited
  91. to 50.  This is a, somewhat, arbitrary limitation and if anyone needs more
  92. capacity let me know.
  93.  
  94. Line 7 begins the DIRs to scan - one per line.
  95.  
  96.  
  97.                               RUNNING PCBLIST2
  98.  
  99. Since the whole program was designed to be run in the event, there is
  100. really nothing left to do except sit back and watch.  Most errors will be
  101. trapped and shown on the screen.  Let me know if there are any problems.
  102. The output file looks like this:
  103.  
  104.               MidWest BBS - Illinois' Professional Bulletin Board              
  105.                24 Hours per Day    300/1200/2400/9600(HST) Baud                
  106.                                 (312) 513-1034                                 
  107.           There are 7,553 files totalling 294,069,244 bytes available          
  108.  
  109.          This list prepared on Tuesday, January 31, 1989 at 5:05 A.M.
  110.  
  111. ============   ======  ========  =============================================
  112. Name           Size    Date      Description
  113. ============   ======  ========  =============================================
  114.  
  115. By the way, I haven't got 7,553 files on the BBS.  This is just the output
  116. from one of the tests I made.  The technical limit on the number of files
  117. is over 30,000, but at about 12,000 files there is substantial degradation
  118.  
  119. Page 3     PCBLIST2.DOC
  120.  
  121.  
  122.  
  123.  
  124.                              HOW IT WORKS
  125.  
  126. When PCBList2 is first started it searches for the configuration file in
  127. the current directory, then in the directory where PCBList.Exe resides, if
  128. different (under DOS 3.0 and greater) and then through the defined Path.
  129. If the file is not found by this time, it gives up and quietly dies after
  130. letting you know what happened.  The only error that isn't trapped, as
  131. far as I know, is if the stated configuration file is a binary file or
  132. directory, it will barf and terminate with a runtime error.
  133.  
  134. File descriptions are accumulated in two files, "MWNEW.189" and "SEC.189",
  135. The first file is for all of the primary descriptions and will be
  136. approximately 40% larger than the total of the DIRs being scanned.  The
  137. other file contains the secondary file descriptions.  Both files are erased
  138. when the program terminates, but please make sure that you have sufficient
  139. disk space for them in the current directory (or ram disk if you wish).
  140. PCBList2 will search for the DIR files in the same manner it looks for the
  141. configuration files.  Everything is stripped from the DIRs with the
  142. exception of primary and secondary descriptions, e.g. headers etc.
  143.  
  144. The sorting is done using Borland's Turbo Sort routine.  After using other
  145. methods, I came back to this for one primary reason - virtual memory.
  146. This effectively eliminates memory constraints from the sorting process.
  147. Unless you have a huge number of files or very limited memory, it will
  148. probably never be necessary for a "spill file" to be created, especially
  149. since the portion of the description being passed to the sort is much more
  150. efficient than the prior versions, but the capability is there.
  151.  
  152.  
  153.                              COME ON DOWN
  154.  
  155. Sysops are always welcome at MidWest BBS.  Just leave me a note and let me
  156. know who you are and your access will be upgraded.  A word of warning - I
  157. travel a good bit the early part of the year, so it might be several
  158. days before the increased access is entered.  PCBList2 is available to
  159. everyone though.  While you're on MidWest, please check out DOOR #7,
  160. Chuck-A-Luck.  It's under construction and I would appreciate any
  161. comments, suggestions etc. - it only takes a couple of minutes to play.
  162.  
  163. Steve Mills, SYSOP
  164.  
  165.  
  166. Last Minute Addition : DRAT! Somewhere around here I must have a simple
  167. program to format ASCII files for a printer, but where!  Anyway, if anyone
  168. else needs it, there is a file in the archive called FORPRINT.EXE.  Just
  169. enter the name of the file you want formatted and the name of the output
  170. file to be created on the command line.  Page length is set at 59, so
  171. those lucky soles with laser printers can get usable output.  Run FORPRINT
  172. without anything on the command line for instructions.  The same license
  173. applies to FORPRINT as stated for PCBList2.
  174.  
  175.  
  176.  
  177. Page 4     PCBLIST2.DOC
  178.  
  179.  
  180. Acknowledgements:
  181.  
  182. PCBoard is Copyright of Clark Development Co.
  183.  
  184.  
  185. The Technical Crap:
  186.  
  187. For those that are interested, Units from Turbo Power's "Turbo
  188. Professional" and Bob Ainsbury's "Technojock's Turbo Toolkit" were
  189. used, as well as the sort routine from Borland's Database Toolbox.
  190. Both TPro and TTT have recently been upgraded and I highly recommend the
  191. purchase of either or both if you do much programming in Turbo Pascal.
  192. After trying a number of Turbo Pascal tools, there is little doubt in my
  193. mind that these offer the best functionality, documentation and bang
  194. for the buck.
  195.  
  196. Also, I can't imagine anyone writing a PCBoard utility without, in some
  197. fashion, relying on the incredible work of Sam Smith.  His concise, well
  198. documented code is indispensible when working with PCBoard files (and many
  199. other things for that matter).  Thanks Sam!
  200.  
  201.  
  202.